MAC ISLAND
Spotify, notes and a file tray, available from the top of your screen.

REQUIREMENTS
An Apple Silicon Mac (M-series chip) running macOS 14 Sonoma or later.
Intel Macs are not supported by this download.
Spotify integration requires the Spotify desktop app on the same Mac.

INSTALL
1. Unzip the download.
2. Drag Mac Island.app into your Applications folder.
3. Open Mac Island from Applications.
4. Move your pointer to the notch to reveal the island. On a Mac without a
   notch, use the top center of the screen. Move away to collapse it.

There is no Dock or menu-bar icon. The app does not start at login automatically.
Right-click an empty area of the open island to quit or see privacy details.

UPDATES
Use the manual update method for now:
1. Download and unzip the newer shared ZIP.
2. Quit Mac Island from the island's right-click menu.
3. Replace Mac Island.app in the same Applications folder with the new copy.
4. Open it again. Your notes and file tray stay in the app's separate container.
The right-click menu also includes How to Update.

This personal build has no active update connection or automatic update alerts.
In-app downloading and Install & Relaunch are prepared for a future signed
public release; installing that first release will be manual.

FIRST-LAUNCH SECURITY PROMPT
This is a locally signed personal build, not an Apple-notarized release.
macOS may block its first launch because the developer cannot be verified.
If you trust the person who shared it, first try opening the app. Then open
System Settings > Privacy & Security and, if offered for Mac Island, choose
Open Anyway and confirm. Managed Macs may not allow this exception.

Apple's instructions:
https://support.apple.com/en-us/102445

If macOS reports that the app is damaged or contains malware, stop and ask
the sender for help. Do not disable Gatekeeper or other system protections.

EVERYDAY USE
- Spotify: open Spotify and play a song. Choose Connect Spotify in the island
  if prompted, then allow the macOS Automation request for Spotify.
  Click the album cover to open Spotify. Playback controls work locally.
  Drag or click the progress bar to seek forward or backward. The time and
  synced lyrics preview your position while dragging; release to move Spotify
  there. The island stays open until you finish dragging, even outside its edge.
  Use the small slider below the playback buttons for Spotify-only volume.
  Click its speaker to mute or restore the previous level. It does not change
  your Mac's system volume or other apps, and lyrics keep following the song.
- Lyrics: click the quote-bubble below the cover for floating lyrics. Drag the
  top strip (including its empty space) to move it; use its dots menu to change opacity. The cursor button lets
  clicks pass through it; the cursor button stays clickable to turn interaction
  back on. You can also right-click the notch and choose Make lyrics interactive. The X hides it and stops lyrics lookups.
- Favourites: click the heart to connect your Spotify account. Once connected,
  click it to save the current track directly to Liked Songs. A filled heart
  means the song is saved; click it again to remove the song from Liked Songs.
  Right-click the island for Spotify Account to connect or disconnect.
- Notes: type to save automatically. Use + for a new note and the stack menu
  to switch between notes or delete one.
- Files: drag files to the notch to open the tray. It stays the default view
  while it contains files. Clear the tray to return to music and notes.
  Removing tray items only removes references, never the original files.
- Escape collapses the island. Right-click empty island space for Quit.

PRIVACY
This download contains only the app and this guide, with no personal notes,
file references, Spotify account details or other user data.

Notes and file references are stored locally in the app's sandbox container.
There are no analytics, ads, notes/files cloud sync, Mac Island server or active
updater in this personal build. Spotify account sign-in is optional. The future
public release will also connect to its GitHub
release host to check for updates and download them when you choose to update.
The app does not request microphone, camera or screen-recording access.
Spotify playback uses local Apple Events with your macOS permission.

Album covers download from i.scdn.co over HTTPS. When floating lyrics are open,
the song title, artist, album and duration are sent to lrclib.net over HTTPS.
Lyrics are cached only in memory; hiding the panel stops lookups. LRCLIB receives
normal network metadata such as your IP address. Lyrics availability varies.
No notes or files are uploaded. Cover requests use no account, cookies or
stored credentials, and covers are cached only in memory. Spotify's image
server receives the requested cover ID and normal connection metadata such
as your IP address. Spotify itself may also use the internet.

Each person starts with their own local notes and file tray.

SPOTIFY ACCOUNT SETUP
For direct favourites, create a Web API app at:
https://developer.spotify.com/dashboard
Register this exact Redirect URI: macisland-spotify://callback
Paste the app's Client ID into Spotify Account in the island's right-click menu.
Choose Connect with Spotify, then sign in on Spotify's own page. Never enter a
Client Secret or Spotify password into Mac Island.

Spotify's development apps currently require Premium for the app owner and
allow five approved users. Add friends in the developer app's User Management
before they connect. Public use needs separate Spotify approval. Playback,
volume and lyrics still work through the desktop app without account sign-in.

Sign-in and favourites connect directly to accounts.spotify.com and
api.spotify.com. Spotify receives your authorization and the current track's
URI to check, save or remove it. Tokens are kept in this Mac's Keychain, with no iCloud
sync or plaintext fallback. Only the non-secret Client ID is in preferences.
Disconnect removes the saved tokens. Notes and file references are never sent.
